home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / doc / libgpod4 / README.SysInfo < prev   
Encoding:
Text File  |  2009-01-17  |  2.8 KB  |  53 lines
  1. Starting with the iPod Classics and the Video Nanos, libgpod needs an 
  2. additional configuration step to correctly modify the iPod content. libgpod 
  3. needs to know the so-called iPod "firewire id", otherwise the iPod won't 
  4. recognize what libgpod wrote to it and will behave as if it's empty.
  5.  
  6. There are several ways to set up an iPod so libgpod can find its firewire id.
  7.  
  8. The preferred method is automatic. Make sure you have hal and libsgutils
  9. installed before running configure/autogen.sh. If you built libgpod without
  10. them, run configure/make/make install after you install them.
  11.  
  12. A hal callout and .fdi file will be built and installed. This will query an iPod
  13. when it is plugged in and save the SysInfoExtended file in the proper place.
  14. This should be entirely automatic. If you have trouble with this, see the
  15. TROUBLESHOOTING file for some hints.
  16.  
  17. If you build with libsgutils but without hal, the next best method is mostly
  18. automatic. You should have an ipod-read-sysinfo-extended tool available. Run it
  19. with the iPod device path and the iPod mount point /mnt/ipod) as arguments. For
  20. example:
  21.  
  22.     $ ipod-read-sysinfo-extended /dev/sda /mnt/ipod
  23.  
  24. This may require root privileges. It reads an XML file from the iPod and writes
  25. it as /mnt/ipod/iPod_Control/Device/SysInfoExtended. More details on this method
  26. can be found at http://ipodlinux.org/Device_Information.
  27.  
  28. Having the SysInfoExtended file created by ipod-read-sysinfo-extended or the hal
  29. callout is enough for libgpod to figure out the iPod firewire id.
  30.  
  31. The last method requires more manual intervention. First, you need to get your
  32. firewire id manually. To do that, run "sudo lsusb -v | grep -i Serial" (without
  33. the "") with your iPod plugged in, this should print a 16 character long string
  34. like 00A1234567891231. For an iPod Touch, this number will be much longer than
  35. 16 characters, the firewire ID is constituted by the first 16 characters.
  36. Once you have that number, create/edit /mnt/ipod/iPod_Control/Device/SysInfo 
  37. (if your iPod is mounted at /mnt/ipod). Add to that file the line below:
  38. FirewireGuid: 0xffffffffffffffff
  39. (replace ffffffffffffffff with the string you obtained at the previous step
  40. and don't forget the trailing 0x before the string)
  41. Save that file, and you should be all set. Be careful when using apps which 
  42. lets you manually specify which iPod model you own, they may overwrite that 
  43. file when you do that. So if after doing that libgpod still seems to write 
  44. invalid content to the iPod, double-check the content of that SysInfo file to
  45. make sure the FirewireGuid line you added isn't gone. If that happens, readd it
  46. to the end of the file, and make sure libgpod rewrite the iPod content.
  47.  
  48.  
  49.  
  50. Once that is done, if you compiled libgpod from source, you can test that 
  51. libgpod can find the firewire ID on your iPod by running 
  52. libgpod/tests/test-firewire-id /ipod/mount/point
  53.